perm filename TOSCIP.DOC[S,DOC] blob
sn#444467 filedate 1979-05-31 generic text, type T, neo UTF8
TOSCIP is a program which may be used to read and write tapes in IBM-
compatible format. Commands exist for setting tape parameters, displaying
the currently selected parameters, moving to a specific file on the tape,
reading, and writing. Some of the more important commands include:
DISPLAY show the currently selected parameters. When reading a tape,
be sure that these match the parameters that were specified when
the tape was written. When writing, be sure to record these
parameters for future reference.
READ filename read the next tape file into the disk file named "filename".
WRITE filename write the disk file named "filename" to tape. You can
specify several filenames separated by commas.
SCIP default select a prepackaged default format compatible with utilities
at SCIP. Currently, you may choose:
CARD --- suitable for card-image data sets and most general portability.
DCB=(RECFM=FB,LRECL=80,BLKSIZE=8000,DEN=3,OPTCD=Q), upper-case
translation on write, delete columns 73-80 on read.
PRINT --- suitable for text files to be printed on an IBM printer.
DCB=(RECFM=FB,LRECL=133,BLKSIZE=7980,DEN=3,OPTCD=Q)
For a list of commands, type "?". For information a particular command,
give the command HELP followed by the name of the command, e.g.:
TOSCIP>help recfm
The following is a complete list of commands, and their descriptions:
ASCII
Sets TOSCIP to read and write without translation until an
EBCDIC command is seen. This assumes that the files will contain
ASCII text.
BLKSIZE decimal number
Sets the tape blocksize to be used for subsequent reads and
writes. This should be an integral multiple of the desired
Logical RECord Length.
DENSITY 800 or 1600 or 2 or 3
Sets the density to be used for subsequent reads and writes.
You may use 800 or 1600 bpi, or the IBM equivalents 2 and 3
respectively. It is not advisable to change densities in the
middle of the tape. LOTS will not mind as long as you are
consistent however you will not be able to read your tape on
an IBM system.
DISPLAY
Display the DCB from the IBM JCL which corresponds to the current
settings of various parameters. This is (almost) the DCB which
should be used to read a tape written here, and it should be the
same as the DCB which was used to write a tape which is being read
here. Note that the blocksize must be an integral multiple of
the logical record length. However, the format command does not
check this. When you actually read or write a file the
blocksize will be forced to an integral number of records so
a FORMAT command which is given after a WRITE will indicate
the format that was actually used.
EBCDIC
Sets TOSCIP to translate to EBCDIC on output and from EBCDIC
on input. Files which contain control characters, other than
tabs, carriage returns, and line feeds may get changed in the
process as not all characters have an equivalent.
EOT
Advance to the end of tape. This command is useful if you wish
to add files to the end of an existing tape.
HELP command-name
Types information on various commands.
LRECL number
Sets the logical record length to be used in subsequent reads
and writes. this may be any value between 1 and 256. If you
need to write a larger size record see a member of the LOTS
staff as there is a minor modification which can be made to the
program which will allow this.
NO RAISE
Sets TOSCIP so that lower case is not converted to upper case
on output. Lower case is NEVER converted to upper case on
input as most programs at LOTS handle upper and lower case
as equivalent.
NO ASCII
Equivalent to EBCDIC.
NO EBCDIC
Equivalent to ASCII.
OMIT column-number
On READing from tape, throw away any characters on a record at or
after this column. The default is "omit 73" which omits the sequence
number columns on card images.
PAUSE
Temporarily exits from the program. The tape drive will still
be assigned to you. You may use any EXEC commands you wish.
If you run another program (without PUSHing) you will have to
get TOSCIP again but this is not fatal. To continue type
CONTINUE, or START, or TOSCIP to the "@" prompt.
QUIT
Exit from TOSCIP. This unloads the tape and deassigns the tape
drive.
RAISE
Sets TOSCIP to convert lower case to upper case on output. Upper
case is NOT converted to lower case on input. It is important to
use this command if you are transferring program text to an IBM
system, since no IBM compiler will accept lower case input. If
you are transferring text, such as a term paper, then you would
probably want to use NO RAISE instead, to insure that the
conversion did NOT take place.
READ output file name
Reads one or more files from the tape, using the current format
settings, in to the designated file. If the BLOCKSIZE is not
an integral multiple of the record length it is rounded toward
the record length. That is if it is less than the record length
it is rounded up, otherwise it is rounded down. The tape is
left after the file which is read. If several file names are
specified (separated by commas), then that many files will be
read from the tape.
RECFM fb or fba
select the record-format "format". On reading from tape, choose the
format in which the file was written. On writing, choose (normally)
one of the following:
FB "fixed block", for card images, etc.
FBA FB, but tape file contains carriage control characters
in col. 1 of each record.
If you specify FBA, then the first character of each logical
record on the tape will be presumed to contain Fortran-style
carriage control characters. Carriage returns, CRLFs, and
form feeds will be converted to or from carriage control
characters as appropriate.
REWIND
Rewinds the tape to load point (beginning).
SCIP print or card
Sets the format to be compatable with the public execfiles
#fromlots and #tolots at SCIP. The options are:
CARD Best for source programs, data, and SPSS input cards.
Translates lower case into upper case with record length=80.
Not good for files that might have lines longer than 80
characters. This format is more efficient than PRINT if all
the lines will fit in 80 characters.
PRINT Best for text files to be printed at SCIP. Inserts carriage
control characters at the beginning of each line, translating
page marks to "1" in column 1. Does not translate lower case
to upper case; record length=133. Wasteful of space if all
the lines are less than 80 characters long.
TEXT Best for text files to be stored on disk or further edited
using Wylbur. Does not translate lower case to upper case;
record length=133. Wasteful of space if all the lines are less
than 80 characters long.
Any or all of the characteristics of the SCIP formats can be changed
after the SCIP command has been given. The only parameter that it
is advised you change is the RAISE/NO RAISE (e.g. if you wanted
lower case with the CARD format).
SKIP decimal integer
Skips the specified number of files forward. A negative
number skips backwards. SKIP 0 is a nop.
WRITE input filespec {,optionally addtional files⎇
Writes a file, or group of files to the tape using the current
format settings. As each file is written the user is notified
of the progress of the transfer. Each filespec may contain
wildcards, and may hence imply writing of several files.